﻿K-MeleonCCF 1.02
================

A lightweight, scriptable Windows browser. Built on K-Meleon (GPLv2) +
the Goanna 6 engine, with Lua hot-reload scripting and a built-in
DeepSeek-powered AI agent sidebar.

QUICK START
-----------
1.  Unzip anywhere you like. No installer, no admin rights required.
2.  Run k-meleon.exe.
3.  (Optional, to enable the AI Agent sidebar:)
    Open `pref\agent\config.md` in any text editor and paste your
    DeepSeek API key on the line that starts with `deepseek_api_key:`.
    Get a key at https://platform.deepseek.com/api_keys.
    Restart K-MeleonCCF (or close + reopen the agent panel) afterwards.

UNINSTALL
---------
Delete the K-MeleonCCF 1.02 folder. Your user profile lives in
`%APPDATA%\K-Meleon` - delete that too if you want a clean wipe.

HIGHLIGHTS
----------
* Native MFC shell, x64, no Electron - ~80 MB RAM at idle.
* Goanna 6.8.1 engine (UXP / Pale Moon lineage), actively maintained.
* Lua 5.1 scripting layer with hot reload: edit any lua\*.lua file
  and the change is live in ~150 ms.
* AI Agent sidebar: describe a task in plain English, the agent reads
  the page, clicks, types, and reports back.
* Live adblock: edit rules in Preferences -> Adblock or right-click
  any image -> "Adblock Image". Filter file watcher re-parses on save.
* Mouse gestures with optional orange trail.
* Left-drag a link sideways to open it in a tab (left = background,
  right = foreground) - shows the standard OLE drop cursor.
* No telemetry, no safe-browsing pings, no phone-home.

LICENSE
-------
GNU General Public License v2. See LICENSE in the distribution root.
Upstream K-Meleon shell (c) 2000-2024 Jeff Doozan & contributors.
Goanna engine by roytam1. K-MeleonCCF rebuild (c) 2026.
